************
INTRODUCTION
************

This file describes how to set up and use the .NET wrapper code with Melissa DATA's Phone Object.



*************
PREREQUISITES
*************

To make use of the Phone Object .NET wrapper sample you will need:

* Visual C# 7 compiler or later version

* The Melissa DATA Phone Object library and data files installed.

  These files are installed automatically if you run setup.exe from the root of the DQ Suite DVD. 
  You will need to know the location of these files.

This sample was compiled and tested using .NET 2.0. 

**********************
Wrapper compatibility
**********************

If the provided pre-compiled wrappers are not compatible with your environment, the necessary files for compilation can be found in the 'interfaces' folder of the object's main directory.

The wrappers included in the x64 and x86 folders of this NET samples folder are compiled in 2012, and would need the Visual Studio 2012 redistributable in order to run correctly.
If you are having compatibility issues and would like to use the 2008 compiled versions of the wrappers, they are located in the 'interfaces/2008Wrappers' folder of the object's main directory.

*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.


*****
Setup
*****

Copy mdPhoneCS.dll and mdPhoneNET.dll from the Source folder to your project directory.
Copy mdPhone.dll from "/phone/windows/dll_32bit" into the same directory as mdPhoneCS.dll and mdPhoneNET.dll.
     * 64bit version available in /address/windows/dll_64bit


********************
What are these DLL's
********************

mdPhone.dll is the standard DLL version of Phone Object used by the .Net wrapper
mdPhoneCS.dll is a intermediary dll that bridges .NET and the unmanaged mdPhone.dll
mdPhoneNET.dll is the .NET assembly which calls mdPhoneCS.dll.

To use the .NET wrapper in a .NET language, add a reference to mdPhoneNET.dll. However, mdPhoneNET.dll must be
able to find mdPhoneCS.dll who must be able to find mdPhone.dll. You can copy all of these files to the same directory, 
or add the directory of those dll's to the PATH environment variable. 


*******************
Running the Sample
*******************

Csharp.NET


Directions can be found in the README file inside the CSharpNet folder.



********************
Other .NET languages
********************
You can use the dll's provided in another .NET language such as VB.NET because mdPhoneNET.dll is a .NET assembly. The
sample provided is written in C# however and you will need to come up with your own code. 

*******
Updates
*******

The files generated/included in this wrapper do not need to be changed for DQ Suite updates unless there is 
a method signature change in the object. If a new method is added, you will need to rebuild the wrapper to use 
the new method. 

**********
64 Bit mode
**********
To use this wrapper in 64bit mode, you must use the 64 bit version of Phone Object and recompile the wrapper dlls on a 64bit machine. To do so, go into the "Source" directory and follow the instructions in CreateDLL.bat. You must use the Visual Studio x64 Command Prompt instead of the 32bit (default) one. 

****
Note
****

The source code and a bat script to compile mdPhoneCS.dll and mdPhoneNET.dll is supplied in the 'Interfaces' directory found 2 folders up. 
These files are already supplied so you do not need to use them unless you need to recompile. 

If you get a crash or exception when trying to run the sample that says "cannot load dll", make sure to copy mdPhone.dll
into the same directory as mdPhoneCS.dll or add its directory to the PATH enviornment variable. 


COPYRIGHT NOTICE

(C) 2014 Melissa Data Corporation. All rights reserved.
